home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 22 / AACD 22.iso / AACD / Utilities / fat95 / english / readme.too < prev   
Encoding:
Text File  |  2001-03-04  |  12.2 KB  |  371 lines
  1. fat95 v2.14 (04-Mar-2001) readme file
  2.  
  3.  
  4. General facts
  5. =============
  6.  
  7. "fat95" is designed for data exchange with other platforms. This means:
  8. media must be made 100% PC compatible. Basically, there are 2 ways of achieving
  9. this:
  10.  
  11. a) "simple", "unpartitioned"
  12.  
  13. The whole storage space of the medium is occupied by one single FAT data
  14. structure. It also implies that there is no AMIGA style partitioning info
  15. (RDB etc.).
  16. This method is common on floppies (DD and HD), magneto-optical disks (MO`s),
  17. and it is - at least in theory - also permitted on ZIP disks.
  18.  
  19. b) "partitioned"
  20.  
  21. There must be a valid PC style "master boot record" (MBR) inside the first
  22. block of the media. fat95 will then evaluate the contained partition table
  23. to figure out the type, location and size of the FAT data partition.
  24. This method is required for harddisks. Usually, ZIP media also do it that way,
  25. although in most cases there will be only one single FAT16 partition spanning
  26. almost all of the storage space.
  27. You best set up partitions using adequate PC tools like "fdisk", "xfdisk" or
  28. "PartitionMagic". These programs normally leave some unused areas between
  29. partition tables and data partitions. You may then utilize suitable AMIGA
  30. tools to ADD parallel AMIGA style partitioning info.
  31. Important: fat95 only looks at the PC style tables. Using only, for example,
  32. "HDToolBox" will thus NOT WORK.
  33.  
  34.  
  35. Setup
  36. =====
  37.  
  38. fat95 is installed in the same way as most other alternative filesystems.
  39. I tried hard to make it quite resistant against wrong or missing mountlist
  40. parameters. However, these are the important ones:
  41.  
  42. FileSystem = L:fat95
  43.  
  44. (or wherever you actually stored it, full path)
  45.  
  46. StackSize = 2048
  47.  
  48. (do not use less, you will risk a crash.)
  49.  
  50. Device = mfm.device
  51. Unit = 0
  52. Flags = 0
  53.  
  54. (which physical drive to use)
  55.  
  56. MaxTransfer = 0x20000    /* simple IDE harddisk @ A1200 */
  57.  
  58. (not needed for floppies and ATAPI devices, eg. ZIP)
  59.  
  60. LowCyl = 0
  61.  
  62. (or just no "LowCyl" entry at all.)
  63.  
  64. Buffers = 20    /* DD Floppy */
  65. Buffers = 40    /* HD Floppy */
  66. Buffers = 100   /* ZIPs, MOs, ... */
  67.  
  68. (quite useful values. When using excessively deep directory trees,
  69. you can try some more buffers.)
  70.  
  71. GlobVec = -1
  72.  
  73. (this is an assembler program)
  74.  
  75. Control = "+s"
  76.  
  77. (forces fat95 into direct SCSI mode rather than trackdisk style.
  78. May help for certain harddisks > 4 Gbyte.)
  79.  
  80. And finally, the worst of all ;-)
  81.  
  82. DosType = 0x464154xx    /* "FATx" */
  83.  
  84. That last byte "xx" serves as the almighty master control.
  85.  
  86.    xx = 00     Choose this for floppies, and for floppies only.
  87.                It activates several special features like trackdisk
  88.                ETD_ commands, and a workaround for some non-mfm.device`s
  89.                that should allow for automatic HD detection now.
  90.  
  91.    xx = 01     The catch-most-of-them universal value. Works with unpartitioned
  92.                media, and will search for for the first FAT partition on
  93.                partitioned media.
  94.  
  95. If you have more than one FAT12, FAT16 or FAT32 partition on your harddisk,
  96. we will have to get a bit more detailled. Just try the LINUX style partition
  97. number:
  98.  
  99.    xx = 01..04 Use "primary" partition of that number.
  100.                "04" would be the exact value for ZIP`s, but "01" should also
  101.                work since the first 3 partition table entries are unused
  102.                on such media normally.
  103.  
  104.    xx = 05..?  Use "logical drive in an extended partition". "05" is the first
  105.                logical drive, "06" the second one etc.
  106.  
  107. You can find some examples in the file of the same name in this dir.
  108.  
  109.  
  110. OS 2.0+ Installation
  111. ====================
  112.  
  113. * Copy the "fat95" file into your L: drawer.
  114. * Doubleclick the "MS0" (internal floppy) or "MS1" example icons to mount now.
  115. * Copy them into the DEVS:DOSDrivers drawer to auto-mount at system start time.
  116. * Create your own mount scrips as needed.
  117.  
  118.  
  119. OS 1.3 Installation
  120. ===================
  121.  
  122. The mfm.device does not work with V 1.3 trackdisk.device. A suitable equivalent
  123. is the messydisk.device by Olaf Seibert. It was originally distributed on a
  124. PD disk called "Time #10" 9 years (!) ago and has now become nearly
  125. unavailable. Therefore I decided to include it here.
  126.  
  127. Doubleclick the "install_fat95_1.3" icon, or
  128.  
  129. * copy the file "fat95" into your "L:" drawer
  130. * copy the files "messydisk.device" and "fat95mountlist" into "DEVS:"
  131.  
  132. Then add this line to your S:Startup-Sequence file:
  133.  
  134. mount ms0: from fat95mountlist
  135.  
  136. Use "ms1:" instead of "ms0:" if you want your second floppy drive to work on
  137. MS-DOS/Win disks.
  138.  
  139.  
  140. Special Issues
  141. ==============
  142.  
  143. When writing into the root drawer of a fat95 disk, you may get the somewhat
  144. strange error message 232 "no more entries in directory". This means:
  145. MS-DOS/Win uses a non-extensible, fixed-size root directory table that can
  146. only hold a limited number of files and sub-dirs even if there is enough
  147. space left on the disk itself. In this case, do one of the following:
  148.  
  149. * store into a sub-directory instead of the root.
  150. * move one or two files into a sub-directory, then try writing again.
  151. * delete one or two root files.
  152. * choose another disk.
  153.  
  154. Unfortunately, I still cannot fully recommend using the messydisk.device.
  155. One very annoying fact is that the MOUNT task will hang until the first
  156. disk change in the appropriate drive is performed. Perhaps this is a race
  157. condition with trackdisk device since everything works quite well in
  158. single step debugging mode.
  159.  
  160. fat95 is now able to recognize NSD (new style device) information and it can
  161. now make use of Trackdisk64 and/or SCSI direct commands for media > 4 Gbyte
  162. as well.
  163.  
  164. Due to several complaints about a disabled "FAT" workbench icon, I decided to
  165. report volumes intentionally incorrect as type "DOS\0". This will make that
  166. icon disappear. I hope and prey that this does not encourage any program to
  167. unqualified direct accessing...
  168.  
  169.  
  170. FAT32 notes
  171. ===========
  172.  
  173. The literally biggest difference compared to the older FAT16 is the so-called
  174. File Allocation Table, or FAT. It usually covers 1/1024 of the entire
  175. partition size. These are impressive 8 Mbytes on an 8 Gbyte partition, for
  176. example. Therefore fat95 does not cache 32bit FAT`s entirely. Access to
  177. fragmented files will slow down a bit this way while you are saving all that
  178. precious memory.
  179.  
  180. The variable storing the currently available free space is another good new
  181. idea... well, at least in theory. The real world does not always keep
  182. it up to date. fat95 rather chooses to calculate the free space out of the FAT
  183. in the old-fashioned way instead. This will take some time directly after
  184. mounting during which you can only read from the volume
  185. ("volume is validating").
  186.  
  187.  
  188. xxxscsi.device hint
  189. ===================
  190.  
  191. Most storage devices are controlled by the scsi.device or a similarly
  192. sounding software module of your controller board.
  193. Currently, I am using a NEC ZIP100 drive at the internal IDE port of
  194. my A1200. Unfortunately the original ROM resident scsi.device does not
  195. like ATAPI hardware at all. It only works with IDE harddisks.
  196. Therefore I recommend installing an appropriate patch, such as
  197. IDE_scsidisk or IDEfix.
  198. By the way: on my machine fat95 comes up to about 110 kbytes/sec, with a
  199. SAMSUNG 8 Gbyte harddisk about 1 Mbyte/sec.
  200.  
  201.  
  202. Troubleshooting
  203. ===============
  204.  
  205. ?: What does the message "object not found" mean when trying to mount
  206.    a fat95 device?
  207. !: Check the "Device =", "Unit =" and "Flags =" MountList entries.
  208.  
  209. If nothing seems to help, you can create a dump of the internal fat95
  210. variables using the included tool "fat95debug". For example, type into
  211. a shell:
  212.  
  213.     fat95debug ms0: ram:ms0.log
  214.  
  215. if the internal floppy drive MS0: refuses to work.
  216. Then send me the just created binary file (about half a kbyte) by email.
  217. I promise there are no passwords or similar secrets in it.
  218.  
  219.  
  220. For the specialists...
  221. ======================
  222.  
  223. ...here is a list of the supported DOS packets so far:
  224.  
  225. 0005    ACTION_DIE
  226. 0007    ACTION_CURRENT_VOLUME
  227. 0008    ACTION_LOCATE_OBJECT
  228. 0009    ACTION_RENAME_DISK
  229. 0015    ACTION_FREE_LOCK
  230. 0016    ACTION_DELETE_OBJECT
  231. 0017    ACTION_RENAME_OBJECT
  232. 0018    ACTION_MORE_CACHE
  233. 0019    ACTION_COPY_DIR
  234. 0021    ACTION_SET_PROTECT
  235. 0022    ACTION_CREATE_DIR
  236. 0023    ACTION_EXAMINE_OBJECT
  237. 0024    ACTION_EXAMINE_NEXT
  238. 0025    ACTION_DISK_INFO
  239. 0026    ACTION_INFO
  240. 0027    ACTION_FLUSH
  241. 0029    ACTION_PARENT
  242. 0031    ACTION_INHIBIT
  243. 0034    ACTION_SET_DATE
  244. 0082    ACTION_READ
  245. 0087    ACTION_WRITE
  246. 1004    ACTION_FINDUPDATE
  247. 1005    ACTION_FINDINPUT
  248. 1006    ACTION_FINDOUTPUT
  249. 1007    ACTION_END
  250. 1008    ACTION_SEEK
  251. 1020    ACTION_FORMAT
  252. 1023    ACTION_WRITE_PROTECT
  253. 1026    ACTION_FH_FROM_LOCK
  254. 1027    ACTION_IS_FILESYSTEM
  255. 1028    ACTION_CHANGE_MODE
  256. 1030    ACTION_COPY_DIR_FH
  257. 1031    ACTION_PARENT_FH
  258. 1033    ACTION_EXAMINE_ALL
  259. 1034    ACTION_EXAMINE_FH
  260. 1035    ACTION_EXAMINE_ALL_END
  261. 4200    ACTION_SERIALIZE_DISK
  262. 4201    ACTION_GET_DISK_FSSM
  263. 4202    ACTION_FREE_DISK_FSSM
  264.  
  265.  
  266. History
  267. =======
  268.  
  269. v1.5    11/1999    first published version
  270.  
  271. v1.6    12/1999    fixed large partition addressing bug
  272.                    added workaround for SID2
  273.                    added volume serial number recognition
  274.                    added directory optimization
  275.  
  276. v1.7    01/2000    fixed minor formatting bug
  277.                    fixed crash on double-mounted volumes
  278.                    made error requesters more informative
  279.                    made code reentrant for multi-device use
  280.  
  281. v1.8    01/2000    added workaround for certain devices who keep
  282.                    trashing forbidden 68k registers
  283.  
  284. v1.11   01/2000    new workarounds for "difficult" devices
  285.                    made drawer operations a bit faster
  286.  
  287. v1.12   01/2000    added on/off feature for ETD_xxx device commands
  288.                    added ACTION_SERIALIZE_DISK packet (used by DiskCopy)
  289.                    made FAT16 mode writeback faster
  290.                    improved disk format recognition
  291.  
  292. v1.13   02/2000    fixed SERIALIZE_DISK bug
  293.  
  294. v1.14   02/2000    fixed bug in updating all FAT copies
  295.                    alternative english version
  296.  
  297. v1.15   02/2000    code optimizations
  298.  
  299. v1.17   02/2000    second published version
  300.                    improved FORMAT command support
  301.  
  302. v1.18   03/2000    first try to implement partition support
  303.  
  304. v1.19   03/2000    fixed partition selection bug
  305.  
  306. v1.20   03/2000    introduced separate directory and file caches
  307.                    added dummy workbench icon suppression
  308.  
  309. v1.21   03/2000    made file access cluster-wise
  310.                    added diskchange messsages to system (IDCMP_DISKINSERTED...)
  311.  
  312. v1.22   03/2000    fixed "large sectors" bug (> 512 bytes)
  313.  
  314. v2.0    04/2000    first try on FAT32
  315.                    fixed another "large sectors" bug
  316.  
  317. v2.1    04/2000    added NSD and TD64 support
  318.                    fixed bug on 28bit entries for FAT32
  319.                    changed intl character handling for short filenames
  320.                    fixed "file creation" timestamp
  321.  
  322. v2.2    06/2000    new restart validator routines
  323.                    longer filenames (65 chars)
  324.                    added FAT32 formatting routines
  325.                    small write access optimizations
  326.                    changed AddBuffers support (like FFS)
  327.                    reworked documentation
  328.  
  329. v2.3    07/2000    added native ExAll() and ExAllEnd()
  330.                    added ChangeMode()
  331.                    bugfixes:
  332.                      ExamineFH()
  333.                      OpenFromLock()
  334.                      Rename()
  335.                      very long path names
  336.                      Workbench support
  337.  
  338. v2.4    07/2000    bugfixes:
  339.                      exclusive locks
  340.                      double MSDOS 8.3 names
  341.  
  342. v2.5    07/2000    new buffering scheme (track-wise)
  343.                    bugfix:
  344.                      free storage space recognition on FAT32
  345.  
  346. v2.6    07/2000    bugfixes:
  347.                      crash when disk is full
  348.                      access to inconsistent files
  349.  
  350. v2.7    08/2000    fixed logigal drive recognition #07+
  351.  
  352. v2.8    08/2000    added software write protection "Lock"
  353.                    added diagnosis tool "fat95debug"
  354.  
  355. v2.9    09/2000    fixed AddBuffers bug
  356.                    ACTION_CURRENT_VOLUME now safer
  357.                    made all access trackwise
  358.  
  359. v2.10   10/2000    now recognizes some more "exotic" partition tables
  360.                    added error requester "TD64 needed but missing"
  361.  
  362. v2.11   12/2000    better FDA compatibility
  363.  
  364. v2.12   02/2001    added "SCSI direct" command support
  365.  
  366. v2.13   02/2001    new buffering system
  367.  
  368. v2.14   03/2001    fixed FAT32 mode bug
  369.  
  370. (EOF)
  371.